1-Minute Observations API icon

1-Minute Observations API

(0 reviews)

Sample Responses

Status 200 - OK - WeatherStation List

{
    "version": "1.0",
    "request-time": "2021-10-05T23:00:43Z",
    "path": "/observations/nz/1-minute/weatherStation",
    "attributes": {
        "dataset": "observation:1minuteobservation",
        "provider": "metservice"
    },
    "results": [
        {
            "WMOID": 55077
        },
        {
            "WMOID": 55083
        },
        {
            "WMOID": 55084
        },
        {
            "WMOID": 90292
        },
        {
            "WMOID": 90294
        },
        {
            "WMOID": 91723
        },
        {
            "WMOID": 91825
        },
        {
            "WMOID": 91845
        },
        {
            "WMOID": 93000
        },
        {
            "WMOID": 93004,
            "ICAOID": "NZCRX",
            "name": "Cape Reinga",
            "latitude": -34.430,
            "longitude": 172.682,
            "elevation": 214
        },
        {
            "WMOID": 93007,
            "ICAOID": "NZKAW",
            "name": "Cape Karikari AWS",
            "latitude": -34.783,
            "longitude": 173.397,
            "elevation": 59
        },
        {
            "WMOID": 93014,
            "ICAOID": "NZKTA",
            "name": "Kaitaia Airport AWS",
            "latitude": -35.068,
            "longitude": 173.286,
            "elevation": 82
        },
        {
            "WMOID": 93015,
            "ICAOID": "NZJKX",
            "name": "Kaitaia Hospital AWS",
            "latitude": -35.119,
            "longitude": 173.261,
            "elevation": 40
        },
        {
            "WMOID": 93018,
            "ICAOID": "NZKOX",
            "name": "Kaeo Radar AWS",
            "latitude": -35.081,
            "longitude": 173.805,
            "elevation": 382
        },
        {
            "WMOID": 93021,
            "ICAOID": "NZKKA",
            "name": "Kerikeri Airport AWS",
            "latitude": -35.263,
            "longitude": 173.911,
            "elevation": 150
        },
        {
            "WMOID": 93023,
            "ICAOID": "NZPEX",
            "name": "Purerua",
            "latitude": -35.125,
            "longitude": 174.017,
            "elevation": 85
        },
        {
            "WMOID": 93028,
            "ICAOID": "NZOKW",
            "name": "Okahu Is AWS",
            "latitude": -35.198,
            "longitude": 174.212,
            "elevation": 70
        },
        {
            "WMOID": 93034,
            "ICAOID": "NZKOE",
            "name": "Kaikohe AWS",
            "latitude": -35.417,
            "longitude": 173.823,
            "elevation": 204
        },
        {
            "WMOID": 93043,
            "ICAOID": "NZHOX",
            "name": "Hokianga Harbour AWS",
            "latitude": -35.540,
            "longitude": 173.367,
            "elevation": 52
        },
        {
            "WMOID": 93055,
            "ICAOID": "NZTKW",
            "name": "Tutukaka Harbour AWS",
            "latitude": -35.613,
            "longitude": 174.545,
            "elevation": 92
        },
        {
            "WMOID": 93057
        },
        {
            "WMOID": 93067,
            "ICAOID": "NZMPX",
            "name": "Marsden Point AWS",
            "latitude": -35.839,
            "longitude": 174.500,
            "elevation": 20
        }
    ]
}

Status 200 - OK - format=json

{
  "version": "1.0",
  "request-time": "2020-06-16T23:37:48Z",
  "path": "/observations/nz/1-minute/weatherStation/93968/latest?format=json",
  "attributes": {
"dataset": "observation:1minuteobservation",
"provider": "metservice",
    "station": "93968",
    "station-alpha": "NZWNK"
  },
  "results": [
    {
      "obs_timestamp": "2020-06-16T23:36:00Z",
      "roadcdn_01mnavg": 10,
      "road_t3_01mnavg": 14.1,
      "roadfrt_01mnavg": 0.82,
      "roadtxt_01mnavg": "Dry",
      "earth02_01mnavg": 14.1,
      "roadflm_01mnavg": 0.01,
      "roadflm_10mnavg": 0.01,
      "road_t3_10mnavg": 14.0
    }
  ]
}

Status 200 - OK - format=cf-json

{
    "attributes": {
        "dataset": "observation:1minuteobservation",
        "provider": "metservice",
        "station": "93968",
        "station-alpha": "NZWNK"
    },
    "dimensions": {
        "time": 1
    },
    "variables": {
        "time": {
            "type": "string",
            "shape": [
                "time"
            ],
            "attributes": {
                "units": "ISO8601 timestamps",
                "calendar": null,
                "ordering": "descending",
                "long_name": "time"
            },
            "data": [
                "2020-06-16T23:35:00Z"
            ]
        },
        "road_t3_01mnavg": {
            "type": "float",
            "shape": [
                "time"
            ],
            "missing_value": null,
            "attributes": {
                "standard_name": "sensor_internal_temperature_average_over_1min",
                "long_name": "Sensor internal temperature ~2 cm averaged over 1 minute",
                "units": "degC",
                "description": "Sensor internal temperature ~2 cm averaged over 1 minute",
                "valid_min": -100.0,
                "valid_max": 100.0,
                "precision": 1
            },
            "data": [
                14.1
            ]
        },
        "roadflm_01mnavg": {
            "type": "float",
            "shape": [
                "time"
            ],
            "missing_value": null,
            "attributes": {
                "standard_name": "road_surface_water_film_height_average_over_1min",
                "long_name": "Road water film height averaged over 1 minute",
                "units": "mm",
                "description": "Road water film height averaged over 1 minute",
                "valid_min": 0.0,
                "valid_max": 500.0,
                "precision": 1
            },
            "data": [
                0.01
            ]
        },
        "roadflm_10mnavg": {
            "type": "float",
            "shape": [
                "time"
            ],
            "missing_value": null,
            "attributes": {
                "standard_name": "road_surface_water_film_height_average_over_10min",
                "long_name": "Road water film height averaged over 10 minutes",
                "units": "mm",
                "description": "Road water film height averaged over 10 minutes",
                "valid_min": 0.0,
                "valid_max": 500.0,
                "precision": null
            },
            "data": [
                0.01
            ]
        },
        "roadtxt_01mnavg": {
            "type": "float",
            "shape": [
                "time"
            ],
            "missing_value": null,
            "attributes": {
                "standard_name": "road_condition_text_average_over_1min",
                "long_name": "Road condition - text (1 minute average)",
                "units": "",
                "description": "Road condition - text (1 minute average)",
                "valid_min": null,
                "valid_max": null,
                "precision": null
            },
            "data": [
                "Dry"
            ]
        },
        "road_t3_10mnavg": {
            "type": "float",
            "shape": [
                "time"
            ],
            "missing_value": null,
            "attributes": {
                "standard_name": "sensor_internal_temperature_average_over_10min",
                "long_name": "Sensor internal temperature ~2 cm averaged over 10 minutes",
                "units": "degC",
                "description": "Sensor internal temperature ~2 cm averaged over 10 minutes",
                "valid_min": -100.0,
                "valid_max": 100.0,
                "precision": 1
            },
            "data": [
                14.0
            ]
        },
        "roadcdn_01mnavg": {
            "type": "float",
            "shape": [
                "time"
            ],
            "missing_value": null,
            "attributes": {
                "standard_name": "road_condition_numeric_average_over_1min",
                "long_name": "Road condition - numeric (1 minute average)",
                "units": "",
                "description": "Road condition - numeric (1 minute average)",
                "valid_min": null,
                "valid_max": null,
                "precision": null
            },
            "data": [
                10
            ]
        },
        "roadfrt_01mnavg": {
            "type": "float",
            "shape": [
                "time"
            ],
            "missing_value": null,
            "attributes": {
                "standard_name": "road_surface_normalized_friction_to_grip_ratio_average_over_1min",
                "long_name": "Road normalised friction/grip averaged 1 minute",
                "units": "0-1",
                "description": "Road Normalised Friction/Grip (0 - 1)",
                "valid_min": 0.0,
                "valid_max": 1.0,
                "precision": 1
            },
            "data": [
                0.82
            ]
        }
    }
}

Status 200 - OK - Response when variable list parameter supplied

{
    "version": "1.0",
    "request-time": "2021-10-06T18:45:23Z",
    "path": "/observations/nz/1-minute/weatherStation/NZKTA/latest?vars=airtemp_01mnavg,windspd_01mnavg,rainfal_01mnacc",
    "attributes": {
        "dataset": "observation:1minuteobservation",
        "provider": "metservice",
        "station": "93014",
        "station-alpha": "NZKTA"
    },
    "results": [
        {
            "obs_timestamp": "2021-10-06T18:43:00Z",
            "rainfal_01mnacc": 0.2,
            "windspd_01mnavg": 7,
            "airtemp_01mnavg": 15.6
        }
    ]
}

Status 400 - Bad Request

{
  "Request-ID": "00000170ea0d525b-2bd8c2",
  "Status": "HTTP Error 400",
  "Summary": "The requested URL cannot be processed",
  "Diagnosis": "Invalid value '939698' for uri parameter stationId. expected maxLength: 5, actual: 6",
  "Info": "Refer to the API documentation"
}

Status 401 - Unauthorized

{
    "Request ID": "00000172778b4a89-2b828",
    "Status": "HTTP Error 401",
    "Summary": "The requested URL cannot be processed",
    "Diagnosis": "Unauthorised",
    "Info": "Please refer to the API documentation for supported endpoints and usage"
}

Status 500 - Internal Server Error

{
  "Request-ID": "00000172778b4a89-2b829",
  "Status": "HTTP Error 500",
  "Summary": "Internal Server Error",
  "Diagnosis": "'until-successful' retries exhausted. Last exception message was: HTTP POST on resource 'http://non-exisent.com:80/observation-manifest/entry/_search' failed: Couldn't resolve address.",
  "Info": "Please contact the Metservice service desk quoting the request ID: 00000172778b4a89-2b829"
}

Reviews